<!DOCTYPE html>
<html>

<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <title></title>
  <meta name="keywords" content="统一地图平台api">
  <meta name="description" content="统一地图平台api">
  <meta name="renderer" content="webkit">
  <meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1">
  <link href="./../script/api.css" rel="stylesheet">
</head>

<body class="restdemo-page">
  <div class="page_wrapper">
    <div data-tpl="" class="content-sidebar has_right">
      <div class="content">
        <div class="crumbs">
          您现在的位置：
          <a>开发</a>
          &gt;
          <a>资源搜索</a>
          &gt;
          <a>关键字搜索</a></div>
        <article>
          <h1 class="title">
            关键字搜索
            <span class="update-time">最后更新时间: 2020年08月19日</span>
          </h1>
          <div>
            <div class="md-container">
              <h2>调用示例</h2>
              <!-- <p>第一步、导入资源文件</p> -->
              <div class="md-demo-code-wrapper">
                <div class="md-demo-code-header"><a class="active">url</a></div>
                <div class="md-demo-code-content">
                  <div class="md-demo-code-content-item active">
                    <pre><code class="html hljs xml">
  http://${IP:PORT}/api/v1/search/keyword?token=c29la2Rmd2Rla2tl&keywords=modeng&city=440100&location=113.388651%2C23.172524&page_num=1&page_size=10
                                        </code></pre>
                  </div>
                </div>
              </div>
              <p>参数说明:</p>

              <div class="md-atomic">
                <div class="table-container" style="width:100%;">
                  <table class="md-table">
                    <thead>
                      <tr>
                        <th><p>名称</p></th><th><p>格式</p></th><th><p>是否必要</p></th><th><p>值说明</p></th>
                      </tr>  
                    </thead>
                    <tbody>
                      <tr>
                        <td><p>keywords</p></td><td><p>任意文本</p></td><td><p>是</p></td><td><p>待查询关键词</p></td>
                      </tr>
                      <tr>
                        <td><p>city</p></td><td><p>6位数字</p></td><td><p>否</p></td><td><p>市/区级行政编号，若不传，将通过location参数定位</p></td>
                      </tr>
                      <tr>
                        <td><p>location</p></td><td><p>逗号分隔的经纬度</p></td><td><p>否</p></td><td><p>用户定位的经纬度，若不传，则搜索不计算距离</p></td>
                      </tr>
                      <tr>
                        <td><p>page_size</p></td><td><p>数字，不大于30</p></td><td><p>否</p></td><td><p>搜索每页数量，默认10</p></td>
                      </tr>
                      <tr>
                        <td><p>page_num</p></td><td><p>数字</p></td><td><p>否</p></td><td><p>查询页序号，从1开始</p></td>
                      </tr>
                    </tbody>
                  </table>
                </div>
              </div>
              
              <p>
                当关键词与类型词或品牌词完全匹配时，进入专题搜索，此时返回值中的poiStyle属性将返回专题样式名称，前端根据poiStyle作区分显示。
                poiStyle的可能值有normal,brand,empty,device等，其中normal代表普通搜索，brand代表品牌搜索，其他为类别搜索。
                当进入专题搜索时，可以有额外的筛选参数和排序参数，如下：
              </p>

              <div class="md-atomic">
                <div class="table-container" style="width:100%;">
                  <table class="md-table">
                    <tbody>
                      <tr>
                        <th><p>名称</p></th><th><p>格式</p></th><th><p>是否必要</p></th><th><p>值说明</p></th>
                      </tr>
                      <tr>
                        <td><p>sort</p></td><td><p>普通字符</p></td><td><p>否</p></td><td><p>按照特定维度排序，默认升序排列，可传DESC代表降序排列。常用的有distance,price,price DESC</p></td>
                      </tr>
                      <tr>
                        <td><p>filters.kind</p></td><td><p>2/4/6位数字</p></td><td><p>否</p></td><td><p>类别编码，一级类别传类别编码前两位数字，二级类别传类别编码前4位数字，三级类别传6位类别编码</p></td>
                      </tr>
                      <tr>
                        <td><p>filters.source</p></td><td><p>数字1~5</p></td><td><p>否</p></td><td><p>数据源。1=>外部POI数据，2=>互联网POI数据，3=>南网自有数据，4=>结构化地址，5=>电网资源。</p></td>
                      </tr>
                      <tr>
                        <td><p>filters.distance</p></td><td><p>数字</p></td><td><p>否</p></td><td><p>筛选特定距离的数据，单位米</p></td>
                      </tr>
                    </tbody>
                  </table>
                </div>
              </div>

              <h2>返回示例</h2>

              <div class="md-demo-code-wrapper">
                <div class="md-demo-code-header"><a class="active">json</a></div>
                <div class="md-demo-code-content">
                  <div class="md-demo-code-content-item active">
                    <pre><code class="html hljs xml">
  {
    "errcode": 0,
    "errmsg": "ok",
    "total": 7,
    "pageNum": 1,
    "pageSize": 10,
    "list": [
      {
        "adcode": "460106",
        "address": "大同二横路26号",
        "alias": null,
        "chaincode": null,
        "children": null,
        "city": "海口市",
        "distance": 469538.98582907836,
        "district": "龙华区",
        "hit": 1,
        "location": "110.33381437,20.038081212",
        "name": "个性·摩登",
        "showLocation": "110.33381437,20.038081212",
        "id": "3700000085219",
        "phone": "13976105028",
        "province": "海南省",
        "source": "2",
        "standbyTypeCode": "210205",
        "standbyTypeName": "美容/美体",
        "voltage": null,
        "stationName": null,
        "traName":null
      }
    ],
    "currentDistrict": {
      "level": 2,
      "centerPoint": "110.328335,20.031358",
      "name": "海口市",
      "adcode": "460100"
    },
    "poiStyle": "normal"
  }
                                        </code></pre>
                  </div>
                </div>
              </div>
              <p>属性说明:</p>
              <div class="md-atomic">
                <div class="table-container" style="width:100%;">
                  <table class="md-table">
                    <tbody>
                      <tr><th><p>属性名称</p></th><th><p>属性说明</p></th></tr>
                      <tr><td><p>poiStyle</p></td><td><p>normal代表普通搜索，brand代表品牌搜索，其他为类别搜索</p></td></tr>
                      <tr><td><p>total</p></td><td><p>总数量</p></td></tr>
                      <tr><td><p>pageNum</p></td><td><p>当前页</p></td></tr>
                      <tr><td><p>pageSize</p></td><td><p>每页数量</p></td></tr>
                      <tr><td><p>currentDistrict.level</p></td><td><p>行政区域级别，0：国家、1：省、2：市、3：县</p></td></tr>
                      <tr><td><p>currentDistrict.centerPoint</p></td><td><p>中心点经纬度</p></td></tr>
                      <tr><td><p>currentDistrict.name</p></td><td><p>行政区划名称</p></td></tr>
                      <tr><td><p>currentDistrict.adcode</p></td><td><p>行政区划编码</p></td></tr>

                      <tr><td><p>list[].adcode</p></td><td><p>区级行政区划编码</p></td></tr>
                      <tr><td><p>list[].address</p></td><td><p>地址</p></td></tr>
                      <tr><td><p>list[].alias</p></td><td><p>地址</p></td></tr>
                      <tr><td><p>list[].voltage</p></td><td><p>电压等级</p></td></tr>
                      <tr><td><p>list[].chaincode</p></td><td><p>品牌编码</p></td></tr>
                      <tr><td><p>list[].province</p></td><td><p>省</p></td></tr>
                      <tr><td><p>list[].city</p></td><td><p>市</p></td></tr>
                      <tr><td><p>list[].district</p></td><td><p>区</p></td></tr>
                      <tr><td><p>list[].children</p></td><td><p>子POI</p></td></tr>
                      <tr><td><p>list[].location</p></td><td><p>导航经纬度</p></td></tr>
                      <tr><td><p>list[].showLocation</p></td><td><p>显示经纬度</p></td></tr>
                      <tr><td><p>list[].id</p></td><td><p>id</p></td></tr>
                      <tr><td><p>list[].standbyTypeCode</p></td><td><p>类型编码</p></td></tr>
                      <tr><td><p>list[].standbyTypeName</p></td><td><p>类型名称</p></td></tr>
                      <tr><td><p>list[].source</p></td><td><p>数据源。1=>外部POI，2=>常规POI，3=>南网关联单位POI，4=>结构化地址，5=>电网资源</p></td></tr>
                      <tr><td><p>list[].stationName</p></td><td><p>变电站</p></td></tr>
                      <tr><td><p>list[].phone</p></td><td><p>电话号码</p></td></tr>
                      <tr><td><p>list[].traName</p></td><td><p>台区名称</p></td></tr>
                    </tbody>
                  </table>
                </div>
              </div>
            </div>
          </div>
        </article>
      </div>
    </div>
  </div>
</body>

</html>